home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / asmutil / asm_n_z.zip / VMODE.DOC < prev    next >
Text File  |  1986-07-07  |  5KB  |  120 lines
  1. VMODE.DOC                                                     Version 1.0
  2. ---------                                                     -----------
  3.  
  4. Copyright (c) 1986  Raymond Moon  ALL RIGHTS RESERVED
  5.  
  6.  
  7. INTRODUCTION
  8. ------------
  9.  
  10. A friend of mine bought a new Zenith 248 which was equipped with an EGA compa-
  11. tible card but soon discovered that the DOS MODE command could not set the
  12. video mode to any of the enhanced EGA video modes.  VMODE is a quick, little
  13. program to solve that.  Also, many games that use graphics exit without
  14. restoring the screen to the previous mode.  Again VMODE is useful and easy way
  15. to reset the screen mode.
  16.  
  17. BACKGROUND
  18. ----------
  19.  
  20.     It uses ROM-BIOS VIDEO_IO (Int 10h) to set the modes.  This program can be
  21. used via the command line or via a menu.
  22.  
  23. USE 
  24. --- 
  25.  
  26.     VMODE is very easy to use.  Just type in 'VMODE' and the following menu is
  27. displayed.
  28.  
  29. Mode  Type      Size   Colors    Adapter
  30.   0   Text     40x25   16(gray)  CGA,EGA,PCjr
  31.   1   Text     40x25   16/8      CGA,EGA,PCjr
  32.   2   Text     80x25   16(gray)  CGA,EGA,PCjr
  33.   3   Text     80x25   16/8      CGA,EGA,PCjr
  34.   4   Graphics 320x200 4         CGA,EGA,PCjr
  35.   5   Graphics 320x200 4(gray)   CGA,EGA,PCjr
  36.   6   Graphics 640x200 2         CGA,EGA,PCjr
  37.   7   Text     80x25   b\w       EGA,MA
  38.   8   Graphics 160x200 16        PCjr
  39.   9   Graphics 320x200 16        PCjr
  40.  10   Graphics 640x200 4         PCjr
  41.  13   Graphics 320x200 16        EGA
  42.  14   Graphics 640x200 16        EGA
  43.  15   Graphics 640x350 b\w       EGA
  44.  16   Graphics 640x350 64        EGA
  45.      Enter desired mode:
  46.  
  47. Now just enter the number of the desired mode followed by a carriage return.
  48. If all goes well, the screen will blank and the LOGO will reappear in the
  49. new mode.
  50.  
  51. To use VMODE in the command line mode, just type in 'VMODE XX' where XX is
  52. the number of the desired mode from the above list.  If the mode is success-
  53. fully set, VMODE return to DOS with a return code of 0.  If VMODE is unsuccessful
  54. fully for any reason, VMODE return to DOS with a return code of 1.  This
  55. allows VMODE to be used in batch files and be tested for success.
  56.  
  57. VMODE only checks to see that the input is one of the above number; no other
  58. checks are made.  If the video mode is set to one not supported by your
  59. hardware, the screen will probably just blank.  To correct this problem,
  60. just type 'VMODE XX' where XX is a supported mode.  This typing will not be
  61. displayed.  THIS WILL WORK; YOU DO NOT HAVE TO REBOOT!
  62.  
  63. ERROR MESSAGES
  64. --------------
  65.  
  66. VMODE:  Need DOS 2.0+
  67.     -VMODE can only be run with DOS versions 2.0 or later.
  68.  
  69. VMODE:  Invalid Mode
  70.     Aborting...
  71.     - Either the entered value on the command line was not one on the above list
  72.       or the entered value could not be interpreted. This error only occurs when
  73.       in the command line mode and causes VMODE to abort with a return code of
  74.       1.
  75.  
  76. ERROR:  Video Mode was not properly set
  77.  - The video mode after setting is not the same as requested. It appears that
  78.    invalid modes are accepted with the screen going crazy, so this error
  79.    message may never be seen.
  80.  
  81. REQUIREMENTS
  82. ------------
  83.  
  84. VMODE requires DOS 2.0+ and about 1K memory to run.
  85.  
  86. USER RESPONSIBILITIES
  87. ---------------------
  88.  
  89. - All users are granted to make as many copies of this program as required.
  90. - There are no restrictions on how many different computers one user may use
  91.   VMODE.
  92. - Copies may be distributed to others as long as the following requirements are
  93. met:
  94.   -- All three files, VMODE.ASM, VMODE.COM, and VMODE.DOC, are transferred as
  95. a whole.
  96.   -- These programs are distributed free of cost. Only the cost of the media
  97. (e.g. diskette) can be charged.
  98.   -- The files are not modified in any way.
  99. - The source code is distributed with the program to encourage user modifica-
  100. tion to meet individual needs, but in no case will any of these modifications
  101. be incorporated and distributed.
  102. - The author encourages comments.  Please leave comments, suggestions, or
  103. suggested modifications in a message on Andy Smith's RBBS (301-956-3396).
  104.  
  105. DISCLAIMER OF WARRANTIES AND LIMITATION OF LIABILITIES
  106. ------------------------------------------------------
  107.  
  108. The author has taken due care in writing this program, and the program is sup-
  109. plied as is. The author makes no expressed or implied warranty of any kind with
  110. regard to this program.  In no event shall the author be liable for incidental
  111. or consequential damages in connection with or arising out of the use of this
  112. program.
  113.  
  114. PROGRAM INFORMATION
  115. -------------------
  116.  
  117. VMODE was assembled using Microsoft MASM v3.0 with the /ml and /a switches set.
  118.  
  119.     6 July 1986                                          Raymond Moon
  120.